Skip to main content
Version: 4.2.x

Upgrade from XDK4.1 to XDK4.2

The main changes on this release are

  • Optional xdk boot flow using isolated methods instead of xdk.load
    • xdk.detectDevice();
    • xdk.loadDevice();
    • xdk.initManagers();
  • Async media state machine
  • XDK media and players async methods
    • prepare()
    • load()
    • play()

Installing XDK 4.2 dependencies​

npm i \
  @accedo/xdk-config@~4.2.0 \
  @accedo/xdk-core@~4.2.0 \
  @accedo/xdk-log@~4.2.0
danger

XDK 4 may introduce breaking changes when upgrading the minor semver number.

Please use the ~ instead of the standard ^ to avoid any updates when the minor number is updated.

Changes and migration steps​

New optional boot flow​

We have implemented a more direct mechanism to boot XDK with a specific device configuration, allowing us to skip the detection phase.

If you want to save some ms use the next boot flow instead

import xdk from '@accedo/xdk-core';
import config from '../config/xdk.config';
import xdkConfig from '@accedo/xdk-config';

xdkConfig.load(config);

- xdk.load();
+ const deviceConfig = xdk.detectDevice();
+ await xdk.loadDevice(deviceConfig);
+ await xdk.initManagers(); // Will set the xdk.media and xdk.storage objects

If you want, you can skip the detect device and the init managers

import xdk from '@accedo/xdk-core';
import config from '../config/xdk.config';
import xdkConfig from '@accedo/xdk-config';
+ import workstation from '@accedo/xdk-device-workstation';

xdkConfig.load(config);

- const deviceConfig = xdk.detectDevice();
+ await xdk.loadDevice(deviceConfig);
- await xdk.initManagers(); // Will set the xdk.media and xdk.storage objects